home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / ren.lzh / RENAME.DOC next >
Encoding:
Text File  |  1991-09-11  |  3.0 KB  |  75 lines
  1. -------------------------------------------
  2. Deluxe Rename program
  3.  
  4.     written by Harry Dodgson with the
  5.     assistance of Mark O'Bryan for some
  6.     of the GEMDOS calls.
  7.     Copyright 1991, Harry Dodgson.
  8.  
  9.     see bottom for distribution notice
  10. -------------------------------------------
  11.  
  12.     I wrote this program to rename groups of files
  13. and to move them from place to place on my hard drive.
  14. I wrote it in True Basic so it is a pretty large binary
  15. program.  There is no sigificant error handling in my
  16. code, but it is robust anyway.  Everything runs from
  17. menu bars and dialogs.  The status window is not
  18. graceful or polished, just usable.
  19.  
  20.     To use it, select the options from the menu bar
  21. to get the file selector box for both the source and
  22. destination directories/names.  I have set it up to
  23. work with both the TOS 1.4 file selector or the LGS
  24. prompt syntax.  There is also a menu option to arrange
  25. the input file characters into a different order than
  26. they started in.
  27.  
  28.     As an example, you can rename a group of files
  29. named:      D:\INCOMING\DIG01TXT.ATA - DIG35TXT.ATA
  30. into        D:\SAVE\DIGEST01.UM - DIGEST35.UM
  31. very easily.
  32.  
  33.     When you choose "Set Old" from the menu bar, you
  34. will get the file selector and can choose the path
  35. specifier and file types, both ? and * being allowed.
  36. The status window will list the files selected.  You can
  37. optionally choose "Set Shuffle" to rearrange the order
  38. of characters.  Then you choose "Set New" to choose the
  39. destination for the files. When you select "Rename" from
  40. the menu bar you are shown the list of files in the
  41. status window and are allowed to cancel the current
  42. operation.  If you choose to continue, then the stus
  43. window will show each file as it is being renamed.
  44.  
  45.     If you don't type in anything for the filenames
  46. in the source file selector, it will assume you want the
  47. entire directory contents.  If you don't select a
  48. shuffle pattern it will leave the characters in the same
  49. order they started in.  If you leave the destination
  50. filename blank, it will assume that you don't want to
  51. force any characters into the destination filename.
  52.  
  53.     To perform the example, you would select the
  54. directory D:\INCOMING and use DIG??TXT.ATA as the source
  55. specifier.  Then set shuffle as 12300045.000 .  Lastly
  56. set the destination specifier for D:\SAVE and DIGEST*.UM
  57. .  Notice that I use 0s as place holders for don't care
  58. entries in the shuffle specifier.  The program will
  59. properly expand and compress the filenames so that there
  60. are not any invalid characters embedded in the filename.
  61. It also doesn't really matter what order you set things
  62. in.  You can choose destination, shuffle, source if you
  63. wish.
  64.  
  65. --------------------------------------------------------
  66.     This is a shareware program.  If you like it,
  67. send me what you think it is worth (say $5.00).  If you
  68. don't like it, send email to dodgson@coyote.cs.wmich.edu
  69. with constructive criticism so I can improve it.
  70.  
  71.     Harry Dodgson
  72.     2355 s. 9th St
  73.     Kalamazoo MI
  74.         49009-9405
  75. --------------------------------------------------------